MV_GIGE_SetTransmissionType

MV_GIGE_SetTransmissionType

Set transmission mode.

API Definition

int MV_GIGE_SetTransmissionType(
  void                         *handle,
  MV_TRANSMISSION_TYPE         *pstTransmissionType
);

Parameters

handle

[IN] Device handle, which is returned by MV_CC_CreateHandle or MV_CC_CreateHandleWithoutLog.

pstTransmissionType

[IN] Transmission mode, see the structure MV_TRANSMISSION_TYPE for details.

Return Value

Return MV_OK(0) on success, and return Error Code on failure.

Remarks

Call this API to set the transmission mode as single cast mode and multicast mode. And this API is supported only by GigEVision camera.

The following sample code is for reference only.

#include "MvCameraControl.h"

bool g_bExit = false;
unsigned int g_nPayloadSize = 0;
//Wait for key input
void WaitForKeyPress(void)
{
    while(!_kbhit())
    {
        Sleep(10);
    }
    _getch();
}

bool PrintDeviceInfo(MV_CC_DEVICE_INFO* pstMVDevInfo)
{
    if (NULL == pstMVDevInfo)
    {
        printf("The Pointer of pstMVDevInfo is NULL!\n");
        return false;
    }
    if (pstMVDevInfo->nTLayerType == MV_GIGE_DEVICE)
    {
        int nIp1 = ((pstMVDevInfo->SpecialInfo.stGigEInfo.nCurrentIp & 0xff000000) >> 24);
        int nIp2 = ((pstMVDevInfo->SpecialInfo.stGigEInfo.nCurrentIp & 0x00ff0000) >> 16);
        int nIp3 = ((pstMVDevInfo->SpecialInfo.stGigEInfo.nCurrentIp & 0x0000ff00) >> 8);
        int nIp4 = (pstMVDevInfo->SpecialInfo.stGigEInfo.nCurrentIp & 0x000000ff);

        //Print the camera's IP address and user defined name
        printf("CurrentIp: %d.%d.%d.%d\n" , nIp1, nIp2, nIp3, nIp4);
        printf("UserDefinedName: %s\n\n" , pstMVDevInfo->SpecialInfo.stGigEInfo.chUserDefinedName);
    }
    else if (pstMVDevInfo->nTLayerType == MV_USB_DEVICE)
    {
        printf("UserDefinedName: %s\n\n", pstMVDevInfo->SpecialInfo.stUsb3VInfo.chUserDefinedName);
    }
    else
    {
        printf("Not support.\n");
    }
    return true;
}

static  unsigned int __stdcall WorkThread(void* pUser)
{
    int nRet = MV_OK;
    MV_FRAME_OUT_INFO_EX stImageInfo = {0};
    memset(&stImageInfo, 0, sizeof(MV_FRAME_OUT_INFO_EX));
    unsigned char * pData = (unsigned char *)malloc(sizeof(unsigned char) * g_nPayloadSize);
    if (pData == NULL)
    {
        return 0;
    }
    unsigned int nDataSize = g_nPayloadSize;
    while(1)
    {
        nRet = MV_CC_GetOneFrameTimeout(pUser, pData, nDataSize, &stImageInfo, 1000);
        if (nRet == MV_OK)
        {
            printf("Get One Frame: Width[%d], Height[%d], nFrameNum[%d]\n"
             stImageInfo.nWidth, stImageInfo.nHeight, stImageInfo.nFrameNum);
        }
        else
        {
            printf("No data[0x%x]\n", nRet);
        }
        if(g_bExit)
        {
            break;
        }
    }
    free(pData);
    return 0;
}

int main()
{
    int nRet = MV_OK;
    void* handle = NULL;
    do
    {
        //Enumerate devices
        MV_CC_DEVICE_INFO_LIST stDeviceList;
        memset(&stDeviceList, 0, sizeof(MV_CC_DEVICE_INFO_LIST));
        nRet = MV_CC_EnumDevices(MV_GIGE_DEVICE | MV_USB_DEVICE, &stDeviceList);
        if (MV_OK != nRet)
        {
            printf("Enum Devices fail! nRet [0x%x]\n", nRet);
            break;
        }
        if (stDeviceList.nDeviceNum > 0)
        {
            for (unsigned int i = 0; i < stDeviceList.nDeviceNum; i++)
            {
                printf("[device %d]:\n", i);
                MV_CC_DEVICE_INFO* pDeviceInfo = stDeviceList.pDeviceInfo[i];
                if (NULL == pDeviceInfo)
                {
                    break;
                }
            PrintDeviceInfo(pDeviceInfo);
        }
    }
    else
    {
        printf("Find No Devices!\n");
        break;
    }
    printf("Please Intput camera index:");
    unsigned int nIndex = 0;
    scanf("%d", &nIndex);
    if (nIndex >= stDeviceList.nDeviceNum)
    {
        printf("Intput error!\n");
        break;
    }
    //Select device and create handle
    nRet = MV_CC_CreateHandle(&handle, stDeviceList.pDeviceInfo[nIndex]);
    if (MV_OK != nRet)
    {
        printf("Create Handle fail! nRet [0x%x]\n", nRet);
        break;
    }

    //Ask for enabling multicast control or monitoring App
    printf("Start multicast sample in (c)ontrol or in (m)onitor mode? (c/m)\n");
    char key;
    do
    {
        scanf("%c", &key);
    }
    while ( (key != 'c') && (key != 'm') && (key != 'C') && (key != 'M'));

    //Search for the adopted mode
    bool monitorMode = (key == 'm') || (key == 'M');

    //Open camera
    if (monitorMode)
    {
        nRet = MV_CC_OpenDevice(handle, MV_ACCESS_Monitor);
    }
    else
    {
        nRet = MV_CC_OpenDevice(handle, MV_ACCESS_Control);
    }
    if (MV_OK != nRet)
    {
        printf("Open Device fail! nRet [0x%x]\n", nRet);
        break;
    }

    //Get data packet size
    MVCC_INTVALUE stParam;
    memset(&stParam, 0, sizeof(MVCC_INTVALUE));
    nRet = MV_CC_GetIntValue(handle, "PayloadSize", &stParam);
    if (MV_OK != nRet)
    {
        printf("Get PayloadSize fail! nRet [0x%x]\n", nRet);
        break;
    }
    g_nPayloadSize = stParam.nCurValue;

    //Specify multicast IP address
    char strIp[] = "239.0.1.23";
    unsigned int nIp1, nIp2, nIp3, nIp4, nIp;
    sscanf(strIp, "%d.%d.%d.%d", &nIp1, &nIp2, &nIp3, &nIp4);
    nIp = (nIp1 << 24) | (nIp2 << 16) | (nIp3 << 8) | nIp4;

    //Specify multicast port number
    MV_CC_TRANSMISSION_TYPE stTransmissionType;
    memset(&stTransmissionType, 0, sizeof(MV_CC_TRANSMISSION_TYPE));
    stTransmissionType.enTransmissionType = MV_GIGE_TRANSTYPE_MULTICAST;
    stTransmissionType.nDestIp = nIp;
    stTransmissionType.nDestPort = 8787;
    nRet = MV_GIGE_SetTransmissionType(handle, &stTransmissionType);
    if (MV_OK != nRet)
    {
        printf("Set Transmission Type fail! nRet [0x%x]\n", nRet);
        break;
    }

    //Start image acquisition
    nRet = MV_CC_StartGrabbing(handle);
    if (MV_OK != nRet)
    {
        printf("Start Grabbing fail! nRet [0x%x]\n", nRet);
        break;
    }
    unsigned int nThreadID = 0;
    void* hThreadHandle = (void*) _beginthreadex( NULL , 0 , WorkThread , handle, 0 , &nThreadID );
    if (NULL == hThreadHandle)
    {
        break;
    }
    printf("Press a key to stop grabbing.\n");
    WaitForKeyPress();
    g_bExit = true;
    Sleep(1000);

    //Stop image acquisition
    nRet = MV_CC_StopGrabbing(handle);
    if (MV_OK != nRet)
    {
        printf("Stop Grabbing fail! nRet [0x%x]\n", nRet);
        break;
    }
    //Close camera
    nRet = MV_CC_CloseDevice(handle);
    if (MV_OK != nRet)
    {
         printf("ClosDevice fail! nRet [0x%x]\n", nRet);
         break;
    }
     //Destroy handle
    nRet = MV_CC_DestroyHandle(handle);
    if (MV_OK != nRet)
    {
         printf("Destroy Handle fail! nRet [0x%x]\n", nRet);
         break;
    }
    while (0);
    if (nRet != MV_OK)
    {
        if (handle != NULL)
        {
             MV_CC_DestroyHandle(handle);
             handle = NULL;
        }
    }
    printf("Press a key to exit.\n");
    WaitForKeyPress();
    return 0;
}

MV_GIGE_SetTransmissionType

Set transmission mode.

API Definition

int MV_GIGE_SetTransmissionType(
  void                         *handle,
  MV_TRANSMISSION_TYPE         *pstTransmissionType
);

Parameters

handle

[IN] Device handle, which is returned by MV_CC_CreateHandle or MV_CC_CreateHandleWithoutLog.

pstTransmissionType

[IN] Transmission mode, see the structure MV_TRANSMISSION_TYPE for details.

Return Value

Return MV_OK(0) on success, and return Error Code on failure.

Remarks

Call this API to set the transmission mode as single cast mode and multicast mode. And this API is supported only by GigEVision camera.

The following sample code is for reference only.

#include "MvCameraControl.h"

bool g_bExit = false;
unsigned int g_nPayloadSize = 0;
//Wait for key input
void WaitForKeyPress(void)
{
    while(!_kbhit())
    {
        Sleep(10);
    }
    _getch();
}

bool PrintDeviceInfo(MV_CC_DEVICE_INFO* pstMVDevInfo)
{
    if (NULL == pstMVDevInfo)
    {
        printf("The Pointer of pstMVDevInfo is NULL!\n");
        return false;
    }
    if (pstMVDevInfo->nTLayerType == MV_GIGE_DEVICE)
    {
        int nIp1 = ((pstMVDevInfo->SpecialInfo.stGigEInfo.nCurrentIp & 0xff000000) >> 24);
        int nIp2 = ((pstMVDevInfo->SpecialInfo.stGigEInfo.nCurrentIp & 0x00ff0000) >> 16);
        int nIp3 = ((pstMVDevInfo->SpecialInfo.stGigEInfo.nCurrentIp & 0x0000ff00) >> 8);
        int nIp4 = (pstMVDevInfo->SpecialInfo.stGigEInfo.nCurrentIp & 0x000000ff);

        //Print the camera's IP address and user defined name
        printf("CurrentIp: %d.%d.%d.%d\n" , nIp1, nIp2, nIp3, nIp4);
        printf("UserDefinedName: %s\n\n" , pstMVDevInfo->SpecialInfo.stGigEInfo.chUserDefinedName);
    }
    else if (pstMVDevInfo->nTLayerType == MV_USB_DEVICE)
    {
        printf("UserDefinedName: %s\n\n", pstMVDevInfo->SpecialInfo.stUsb3VInfo.chUserDefinedName);
    }
    else
    {
        printf("Not support.\n");
    }
    return true;
}

static  unsigned int __stdcall WorkThread(void* pUser)
{
    int nRet = MV_OK;
    MV_FRAME_OUT_INFO_EX stImageInfo = {0};
    memset(&stImageInfo, 0, sizeof(MV_FRAME_OUT_INFO_EX));
    unsigned char * pData = (unsigned char *)malloc(sizeof(unsigned char) * g_nPayloadSize);
    if (pData == NULL)
    {
        return 0;
    }
    unsigned int nDataSize = g_nPayloadSize;
    while(1)
    {
        nRet = MV_CC_GetOneFrameTimeout(pUser, pData, nDataSize, &stImageInfo, 1000);
        if (nRet == MV_OK)
        {
            printf("Get One Frame: Width[%d], Height[%d], nFrameNum[%d]\n"
             stImageInfo.nWidth, stImageInfo.nHeight, stImageInfo.nFrameNum);
        }
        else
        {
            printf("No data[0x%x]\n", nRet);
        }
        if(g_bExit)
        {
            break;
        }
    }
    free(pData);
    return 0;
}

int main()
{
    int nRet = MV_OK;
    void* handle = NULL;
    do
    {
        //Enumerate devices
        MV_CC_DEVICE_INFO_LIST stDeviceList;
        memset(&stDeviceList, 0, sizeof(MV_CC_DEVICE_INFO_LIST));
        nRet = MV_CC_EnumDevices(MV_GIGE_DEVICE | MV_USB_DEVICE, &stDeviceList);
        if (MV_OK != nRet)
        {
            printf("Enum Devices fail! nRet [0x%x]\n", nRet);
            break;
        }
        if (stDeviceList.nDeviceNum > 0)
        {
            for (unsigned int i = 0; i < stDeviceList.nDeviceNum; i++)
            {
                printf("[device %d]:\n", i);
                MV_CC_DEVICE_INFO* pDeviceInfo = stDeviceList.pDeviceInfo[i];
                if (NULL == pDeviceInfo)
                {
                    break;
                }
            PrintDeviceInfo(pDeviceInfo);
        }
    }
    else
    {
        printf("Find No Devices!\n");
        break;
    }
    printf("Please Intput camera index:");
    unsigned int nIndex = 0;
    scanf("%d", &nIndex);
    if (nIndex >= stDeviceList.nDeviceNum)
    {
        printf("Intput error!\n");
        break;
    }
    //Select device and create handle
    nRet = MV_CC_CreateHandle(&handle, stDeviceList.pDeviceInfo[nIndex]);
    if (MV_OK != nRet)
    {
        printf("Create Handle fail! nRet [0x%x]\n", nRet);
        break;
    }

    //Ask for enabling multicast control or monitoring App
    printf("Start multicast sample in (c)ontrol or in (m)onitor mode? (c/m)\n");
    char key;
    do
    {
        scanf("%c", &key);
    }
    while ( (key != 'c') && (key != 'm') && (key != 'C') && (key != 'M'));

    //Search for the adopted mode
    bool monitorMode = (key == 'm') || (key == 'M');

    //Open camera
    if (monitorMode)
    {
        nRet = MV_CC_OpenDevice(handle, MV_ACCESS_Monitor);
    }
    else
    {
        nRet = MV_CC_OpenDevice(handle, MV_ACCESS_Control);
    }
    if (MV_OK != nRet)
    {
        printf("Open Device fail! nRet [0x%x]\n", nRet);
        break;
    }

    //Get data packet size
    MVCC_INTVALUE stParam;
    memset(&stParam, 0, sizeof(MVCC_INTVALUE));
    nRet = MV_CC_GetIntValue(handle, "PayloadSize", &stParam);
    if (MV_OK != nRet)
    {
        printf("Get PayloadSize fail! nRet [0x%x]\n", nRet);
        break;
    }
    g_nPayloadSize = stParam.nCurValue;

    //Specify multicast IP address
    char strIp[] = "239.0.1.23";
    unsigned int nIp1, nIp2, nIp3, nIp4, nIp;
    sscanf(strIp, "%d.%d.%d.%d", &nIp1, &nIp2, &nIp3, &nIp4);
    nIp = (nIp1 << 24) | (nIp2 << 16) | (nIp3 << 8) | nIp4;

    //Specify multicast port number
    MV_CC_TRANSMISSION_TYPE stTransmissionType;
    memset(&stTransmissionType, 0, sizeof(MV_CC_TRANSMISSION_TYPE));
    stTransmissionType.enTransmissionType = MV_GIGE_TRANSTYPE_MULTICAST;
    stTransmissionType.nDestIp = nIp;
    stTransmissionType.nDestPort = 8787;
    nRet = MV_GIGE_SetTransmissionType(handle, &stTransmissionType);
    if (MV_OK != nRet)
    {
        printf("Set Transmission Type fail! nRet [0x%x]\n", nRet);
        break;
    }

    //Start image acquisition
    nRet = MV_CC_StartGrabbing(handle);
    if (MV_OK != nRet)
    {
        printf("Start Grabbing fail! nRet [0x%x]\n", nRet);
        break;
    }
    unsigned int nThreadID = 0;
    void* hThreadHandle = (void*) _beginthreadex( NULL , 0 , WorkThread , handle, 0 , &nThreadID );
    if (NULL == hThreadHandle)
    {
        break;
    }
    printf("Press a key to stop grabbing.\n");
    WaitForKeyPress();
    g_bExit = true;
    Sleep(1000);

    //Stop image acquisition
    nRet = MV_CC_StopGrabbing(handle);
    if (MV_OK != nRet)
    {
        printf("Stop Grabbing fail! nRet [0x%x]\n", nRet);
        break;
    }
    //Close camera
    nRet = MV_CC_CloseDevice(handle);
    if (MV_OK != nRet)
    {
         printf("ClosDevice fail! nRet [0x%x]\n", nRet);
         break;
    }
     //Destroy handle
    nRet = MV_CC_DestroyHandle(handle);
    if (MV_OK != nRet)
    {
         printf("Destroy Handle fail! nRet [0x%x]\n", nRet);
         break;
    }
    while (0);
    if (nRet != MV_OK)
    {
        if (handle != NULL)
        {
             MV_CC_DestroyHandle(handle);
             handle = NULL;
        }
    }
    printf("Press a key to exit.\n");
    WaitForKeyPress();
    return 0;
}